/*
 *  Copyright © 2011 by Rob Cash
 * 
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 * 
 *       http://www.apache.org/licenses/LICENSE-2.0
 * 
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 * 
 * Tag.java
 * 
 * Created on Jun 20, 2011 at 10:27:01 PM
 */
package org.robcash.apps.bookmarksync.vo;

import java.util.Collection;
import org.robcash.apps.bookmarksync.BookmarkSyncException;

/**
 * Bookmark tag
 * @author Rob Cash
 */
public interface Tag
{
    /**
     * Get the name of the tag
     * @return Name of the tag
     * @throws BookmarkSyncException Thrown if the name cannot be returned
     */
    String getName() throws BookmarkSyncException;
    
    /**
     * Get the description of the tag
     * @return Description
     * @throws BookmarkSyncException Thrown if the description cannot be returned
     */
    String getDescription() throws BookmarkSyncException;
    
    /**
     * Get the bookmarks associated with this tag
     * @return Bookmarks associated with this tag. This may be empty, but it
     * will never be null.
     * @throws BookmarkSyncException Thrown if the description cannot be returned
     */
    Collection<Bookmark> getBookmarks() throws BookmarkSyncException;
    
}
